*****************************************************************************************
*				SYSTEM UTILITIES V2.5					*
*                            ***************************				*
*											*
*       			   By MurBeck 2000					*
*											*
*				    April 2000						*
*****************************************************************************************
	-------------------------------------------------------------------------
  +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

****************************************************************************************
I)	Introduction
II)	Setup
III)	Functions/ How to use
IV)	Bugs/History
V)	Other Programs/ Conclusion
*****************************************************************************************

I)	Introduction

	This program was made using TIGCC C and compiled with the standard tigcclib.
I included the project file in this download so you can view it and possibly learn from
it.   It is very ugly code if I might say so.   It is open source, so feel free to edit
it to your liking, so long as you give me credit for the original.(also e-mail me, I would
love to see someone else's work.)   I encourage you to use this in any of your programs
and other such things (that is what it was made for!)

II)	Setup

	Lucky for you this program is Nostub. (for those of you unfamiliar with this it 
simply means that you don't have to install Doors or some other kernel for it to work.)
all you need do is send it to your calculator and run it as you would any other program,
from the home screen or through another program.   I have tested it in many different
scenarios but try to use the right number of arguments for the function you are using.
If the function calls for two and you only give it one there might not be an error, then
again there might be.  The safe thing to do is just be careful (and don't get mad at me!)

III)	Functions/ How to use

	Here is the list of functions and there required arguements.

-----------------------------------------------------------------------------------
 FUNC #1	sysutil(1)  -  Increased the contrast one level

 FUNC #2	sysutil(2)  -  Decreases the contrast one level

 FUNC #3	sysutil(3)  -  Returns the current setting for the Automatic Power-Down (APD).
			      So if you were to write sysutil(3) on the home screen (or in a
			      program) you would get a number representing the current setting
 
 FUNC #4	sysutil(4,x)-  Sets number entered in x to the APD timer

 FUNC #5	sysutil(5)  -  This function can be used to scramble the screen (extremely
			      slow) In order to recover the status line use sysutil(7)

 FUNC #6	sysutil(6)  -  Resets the calculator memory.  If you have Archive Utility
			      installed there may be an error however it is unlikely...

 FUNC #7	sysutil(7)  -  Recoveres the status line in the event that it was tampered
			      with.  Redraws the line, clears what's under it and rewrites it

 FUNC #8	sysutil(8)  -  Turns the calculator off

 FUNC #9	sysutil(9)  -  Puts the calc into and Idle (battery conserving) loop while it
			      waits for ANY key press. (not [ON] key of course)

 FUNC #10	sysutil(10) -  Locks up calculator so you have to reset in order to restore.
			      You never know where this might be useful and it can't be done
			      from TI-Basic.

 FUNC #11	sysutil(11) -  Sets the font to the smallest setting.   In order for it to
			      work you have to furst call the graph screen (DispG), then call
			      sysutil(11), then use PxlText command to display text.   There
			      will be, unfortunately, an error in the spacing.   So a small
			      Basic routine may need to be written to fix this (if you care)

 FUNC #12	sysutil(12) -  Sets font back to the normal (see above)

 FUNC #13	sysutil(13) -  Sets font to the large setting (see above)

 FUNC #14	sysutil(14) -  Clears the entire screen.  Use sysutil(7) to recover status
			      line contents.

 FUNC #15	sysutil(15) -  Performs a garbage collection of the archive memory. cannot be
			      done from TI-Basic.

 FUNC #16	sysutil(16,x) -  Puts a string into the system clipboard.  From the home screen
			        you can press F1:Paste to paste it to the entry line.

 FUNC #17	sysutil(17,x) - Resets the calculator's timer (USER_TIMER) to the value you
			       entered as x. (must be a positive number) Timer counts down
			       not up!

 FUNC #18	sysutil(18) -  Returns the current value of the calculator's timer (USER_TIMER)
			      in the form of a number.  If you enter it from the home screen
			      you will get a number telling you the current time.

 FUNC #19	sysutil(19) -  Disables the 'Break' key so that you can't press it from a 
			      Basic program to exit it. Could be useful. Use carefully, if
			      you have an error in your program and this is still on you
			      won't be able to exit and will have to reset. This also clears
			      the key so that is it was pushed while it was off it will not
			      break the program when re-enabled.

 FUNC #20	sysutil(20) -  Re-Enables the 'Break' key so that you CAN press it from a
			      Basic program to exit.

 FUNC #21	sysutil(21) -  Nil, Nada, nothin'.  This function simply returns to where it
			      was called.

 FUNC #22	sysutil(22) -  Opens the Mode dialog box and lets you edit its contents.
 
 FUNC #23	sysutil(23) -  Displays the box showing the Help keys.

 FUNC #24	sysutil(24) -  Fills the (entire) screen with black pixels.

 FUNC #25	sysutil(25) -  Fills the (entire) screen with XORed pixels (reverses the color)

 FUNC #26	sysutil(26,[x]) -  Returns a list of folders on your calculator.  If you 
				  include a second arguement (x) which is the name of a 
				  folder it will return a list of variables in that folder.

 FUNC #27	sysutil(27,[x]) - Returns the size of the file whose name is typed in as x.
				 make sure that it is in a string form and is a proper
				 variable name.  If the var doesn't exist, it will return a
				 trash value. If [x] is not a proper file name, it will 
                                 (most likely) crash. Make sure and don't use capital letters,
				 it may not find the right file and return a junk value.

 FUNC #X	sysutil(x)  -  This function writes a text to the status line.  Simply enter
			      a string instead of a function # and it will be handled.  Make
			      sure that the string can fit on the status line.

 FUNC >27	Anything greater than 27 will paste "Bad Input (1-27) on the screen.  (that's
		why there is a FUNC #21.)

	HOW TO USE:

	This is a program that can be called as a subroutine from another program or from the
main screen, just as any other program.   It then will put any return value into a special
variable called 'sysvar'.  The type of variable (str,expr,etc..) depends upon the type of
return value.  In a function not returning any value it will simply return the value of the
function you called.
		

IV)	Bugs/ History

	There aren't any bugs that I know of yet just make sure you enter the right argument 
for what you want it to do and you should be fine.  You can launch it from an explorer if 
you like but it won't do anything.

	If you use FUNC #19 to turn off the break key it may be re-activated by the Operating
System.  Use it with only low-level commands (i.e. not Dialog, Toolbar, etc..)  Make sure to
re-call FUNC #19 every now and then so that it will clear the break key and in the event the
OS re-activates it after you pushed it, the program will not be aborted.  BE CAREFUL!

	HISTORY:

	This is my first finished project in C for the TI-92Plus.  I have already started on
many more demanding and exciting projects that I should have ready within the year. I was
always mad at the incompatability between kernel requiring programs and such.  My plan is to
provide all the people out there with a 92Plus lots of games that are error free and need
no kernel to run.   We'll see what happens...

	December 2, 2000..............Came up with the idea of a system utility and started

	January 2001..................Project halted as I am busied with other things(homework)

	Febuary 2001..................Remembered I had started this and spent a day finishing
				      and debugging it

	March 2001....................I placed version 1.0 on TICalc.Org

	April 2001....................I added some functions and made it compatible with AMS
				      version 2.xx

V)	Other Programs/ Conclusion

	World Conquest - Build a base, research and buy weapons, and move your fleet around
the world to engage terrorist and enemy forces. about 60K with optional programs that can
be deleted to save memory.
	Bowling - The classic game now for TI92 Plus!
	Gunner - Timing release of shells to destroy alien craft could get you into the
high scores table. Not so much shoot 'em up as timing game.
	NavigatorOS - organize and adjust the tools and memory of your calc. Low memory,
quick, and crash-free. Keep track of programs, low-level password protection, graphical
memory view, tool management, and system cleanup.  The must have thing if you use your 
calc for more than games.
	Schedule - professional and student version for the Navigator
	Savings - organize your bank account. For the Navigator.
	Encyclopedia - Keep track of different notes and pictures in an encarta-like
encyclopedia.
	Art Studio - Cut, Copy, Paste, Save, and many other functions to cut down on the time
it takes for you to develope pictures.
	Chat - guidebook chat program.
	Media Player - edit and play music from ti-basic. It stores the music in a list
file for later inturpretation.  You can call it from other programs and use it to play
music either as a whole or one part at a time.
	Picross - race against the clock to solve puzzles of multiple size and difficulty, 
up to 48 different puzzels can be loaded onto your calc at one time! You can download other
puzzels as they are created!

		CONCLUSION:

	MurBeck is a company that makes freeware for computers and calculators.  Look
for other programs made by us on TICalc.Org.  If you wish to join us or send us comments
E-mail:		Augurean@aol.com    -or-
       		Dracko22@aol.com

	This program can be distributed freely, in fact it is encoraged!  We suggest if
you like this program you look at Navigator for the ti92 plus and some of the other
programs available as tools for it.  Thank you.

				Stephen Schloterbeck